home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / program / gemxx19.zoo / gem++19 / man / gemhf.man < prev    next >
Text File  |  1993-05-04  |  2KB  |  74 lines
  1.                      GEM++ - C++ LIBRARIES FOR GEM/AES/VDI
  2.  
  3.  
  4.  
  5. NAME
  6.      GEMhotform - GEMform with auto-select
  7.  
  8. DESCRIPTION
  9.      A GEMhotform is a GEMform that behaves more like a menu, in that
  10.      selectable items are selected under the mouse cursor as it moves.
  11.      Also, clicks outside the form exit the form, returning -1 rather
  12.      than chiming.
  13.  
  14.      This is useful for many form applications, such as pop-up menus.
  15.  
  16. CONSTRUCTORS
  17.      GEMhotform(const GEMrsc& rsc, int RSCindex)
  18.        As per GEMform
  19.  
  20. METHODS
  21.      const int NoObject=-1
  22.        Returned by FormDo() (and hence Do()) if no object is chosen in
  23.        the form.
  24.  
  25.      virtual int DoKey(int meta, int key)
  26.        Called when a key is pressed.  meta is the state of the shift,
  27.        alt, control, and capslock keys, key is the scancode byte and
  28.        the character byte of the key pressed - character in the lowest
  29.        byte, scancode in the next-to-lowest If a value other than
  30.        Ignore (see below) is returned, the FormDo() terminates,
  31.        returning that value.  By default, this method returns Ignore.
  32.        Note that normal key processing (editing, etc) is done AFTER
  33.        this method is called, and only if it returns Ignore.
  34.  
  35.      virtual int DoOff()
  36.        Called when the mouse is clicked outside the form.
  37.        Default is to return NoObject.
  38.  
  39.      virtual int DoHot(int ob, bool inside)
  40.        Called when the mouse moves into or out-of a selectable object.
  41.        Default is to select/deselect the object.
  42.  
  43. EXTENSION
  44.      const int Ignore=-2
  45.        See Do*() methods above.
  46.  
  47.      virtual int FormDo()
  48.        Overrides GEMform::FormDo(), and uses the Hot Form version of
  49.        form_do() written by Tim Oren in the Professional GEM series.
  50.  
  51. SEE ALSO
  52.      GEMform
  53.      "Profession GEM" by Timothy Oren, an usenet/BBS/GEnie/etc document.
  54.  
  55. BUGS
  56.      Bugs in GEM++ should be reported to warwick@cs.uq.oz.au
  57.  
  58. AUTHOR
  59.      Original code by Tim Oren, made public.
  60.      C++ conversion and exit-on-offclick by
  61.        Warwick Allison, 1993.
  62.        warwick@cs.uq.oz.au
  63.  
  64. COPYING
  65.      This functionality is part of the GEM++ library,
  66.      and is Copyright 1993 by Warwick W. Allison.
  67.  
  68.      GEM++ is free and protected under the GNU Library General Public
  69.      License.
  70.  
  71.      You are free to copy and modify these sources, provided you
  72.      acknowledge the origin by retaining this notice, and adhere to
  73.      the conditions described in the GNU LGPL.
  74.